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DOCTOR (Midas Debugger) is a symbolic debugging program for 
the TX-Oo It occupies upper memory starting at register 15000* In 
addition, the symbol table builds down into lower memory. The ini- 
tial symbol table includes all TX-0 operations, and occupies down 
to register 14455. Entry point of DOCTOR is at register 15000, 

Operation of DOCTOR is from the on-line Flexo*rriter« Lower 
case letters and numerals are symbol constituents; other characters., 
and characters typed in upper case are either control characters 
or are Illegal o A symbol consists of one to six letters and/or 
numerals, of "which at least one must be a letter <, A string of 
digits alone is taken as an octal or decimal number o The symbol 
syntax is the same as that of MIDAS.. DOCTOR will read absolute 
binary tapes produced by MIDAS, and also MIDAS symbol punches for 
the purpose of informing itself of the user's symbol definitions. 

On© of DOCTOR'S most useful features is the "breakpoint*" 
When debugging a program, it is occasionally desirable to allow con- 
trol to flow up to a certain point, at which the programmer would 
like to examine the contents of the AC„ IB., XR and various other 
registers in his program <, To facilitate this, DOCTOR will insert 
into the user 8 s program a transfer Instruction into Itself, which 
will cause the AC, LR, and XR to be saved and printed out* It is 
then possible to examine arbitrary program locations, make changes 
as necessary, move the breakpoint if desired, and continue the pro- 
gram, restoring all indicators and executing the instruction which 
was originally replaced by the breakpoint transfer,. 
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/ 



carriage 
return 



backspace 



tape feed 



following list describes the action of typed in char- 

ACTIOH 
separation character meaning arithmetic plus* 
separation character meaning arithmetic plus* 
separation character meaning arithmetic minus, 
register examination character; preceded by an ad- 
dress, causes the addressed register to be opened, 
and the location sequence to be reset to this ad- 
dress e Snmediately following a register printout, 
it will cause the register addressed therein to be 
opened . Opening a register causes the contents to 
be typed out as an instruction or constant, accord- 
ing to the current mode and makes the contents 
available for modification « 
same as |, but forces printout as octal constant for 

this examination* 
same as |, but forces printout as instruction for 

this examination . 
if a register is open for examination and any expres- 
sion has been typed immediately prior to the car- 
riage return, the value of that expression is 
stored in the open register. Otherwise, no change 
is made* 
has same effect as carriage return, but then opens the 
next sequential register,, This sequence is not al- 
tered by additional |, (, or / characters typed after 
a register has been opened* 
same as backspace, but opens the previous register. 



CHARACTER ACTION 

tab same as carriage return, but opens the register ad- 
dressed by the contents of the last opened register 
(after modification, if any). Tab alters the se- 
quence of locations . 
= types out the last quantity as an octal integer. 

I types out the last quantity as an instruction, 

3 types out the last quantity as flexo code, in the 

order right, middle, left, 
as a single symbol, has the value of the current lo- 
cation* Follofcring a string of digits, means 
decimal (integer), 

A has the value of the location in which the preserved 

accumulator is stored » 

L has the value of the location in which the preserved 

live register is stored* Register L immediately 
follows register A in DOCTOR* 

X has the value of the location In which the preserved 

index register is stored. Register X immediately 
follows register L in DOCTOR. 

F has the value of the register containing the lowest 

location being used by DOCTOR for symbols* Its 
contents will change from time to time, as symbols 
are defined. RegiBter P immediately follows reg- 
ister X in DOCTOR, 

M has the value of the register which contains the mask 

used in searches (see below )* Register M+l contains 
the lower limit of all searches, and M+2 contains 
the upper limit. Register M immediately follows 
register F in DOCTOR w 
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CHARACTER ACTION 

Q has the value of the last quantity typed by DOCTOR or you, 
x causes the last three characters typed in to be taken as 

their flexo code value * This applies only to letters 

or numerals* 
° print integers in octal • 
print integers in decimal* 
, when preceded by a legal symbol, causes that symbol to 

be defined as the current location. 
_ when preceded by a legal symbol, causes that symbol to 

be defined as the address part of the last quantity 

typed by DOCTOR or you* 
K deletes all but initial symbols by setting the contents 

of P back to its initial value, Any redefinitions of 

Initial symbols are not affected. 
; sets the symbol definition value to the expression typed 

by either DOCTOR or the operator beforehand. (See 

below) 
) causes the legal symbol typed immediately preceding the ) 

to be defined as the current symbol value, as set 

by : or , 
S sets the mode in which DOCTOR types out words to symbolic . 
C sets the mode in which DOCTOR types out words to octal 

constants . 
R sets the mode in which DOCTOR types out locations to 

relative ( symbolic )<. 
sets the mode in which DOCTOR types out locations to 

octal « 
W causes DOCTOR to search memory between the limits speci- 

fied in M+l and M+2, for words equal to the expression 
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CHARACTER 



N 



delete 



case 

shifts 

B 



ACTION 
preceding the Wo Only bits masked 1 in register M are 
compared. All occurrences are typed out with their lo- 
cations o Typing W alone is an error * DOCTOR will not 
search itself, 
same as W, but finds all words not equal to the expres- 
sion typed preceding the N> 
causes DQU"Ontn 3earch memory for all words whose address 
is equal to that of the expression preceding the E, 
deletes all typed input since last DOCTOR printout, un- 
less the operator has typed an intervening carriage 
return., 
inform DOCTOR of the case in which the operator is typ- 
ing, are otherwise i^iored* 
conditions DOCTOR to insert a breakpoint at the location 
specified before the B. If no such location was speci- 
fied* DOCTOR removes the previous breakpoints A break- 
point is actually inserted only when a G, P, or U is 
executed (see below). DOCTOR will remove the instruc- 
tion at the break location, and will save it for future 
restoration. The instruction at the break-location is 
only executed after the proceed is given, 
after the break trap occurs, causes DOCTOR to proceed 
with the user's program . The proceed will cause the 
instruction which was at the break- location to be exe- 
cuted and control to return to the user's program at 
the point at which it was interrupted, after all regis- 
ters and indicators have been restored. If the break- 
point was moved after a trap., control will still return 
to the instruction trapped by the last breakpoint. 
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CHABACTER ACTION 

V execute the preceding expression as an instruction. The 

breakpoint, if any, and all registers and indicators 
will be set up and saved • 
G S2 *° the location specified before the G. All indica- 

tors and registers will be restored, and the break- 
point, if any, will be inserted. Typing G alone is 
an error « 

Y read a binary tape in standard binary block format. 

The tape is read into storage between the limits spe- 
cified in M-KL and M+2„ If a checksum error is en- 
countered, the program will stop. It is then possible 
to move the tape back one block, and press Restart to 
continue reading, if desired. 

T read MIDAS symbol table , and merge it with the exist- 

ing symbol table * Definitions on tape take prece- 
dence over definitions in storage., The new contents 
of register F are typed out upon completing reading 
the symbol section of the tape* Checksum errors are 
handled as in Y. A number preceding T is taken as 
relocation to be applied to relocatable symbols. 

v verify : reads a binary tape in binary block format and 

compares it against memory between locations speci- 
fied by M+l and M+2 U No change is made to memory. 
Discrepancies are typed out as: 

location/ memory tape 

Checksum errors are handled as in Y„ 
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CEARACTSR ACTION 

H puts DOCTOR into the title punch listen loop. Characters 
typed in are punched out in readable format on paper 
tape.. The terminating characters are tab, carriage re- 
turn, or backspace, which do the following , 

tab: sets DOCTOR to punch read-in mode data blocks , 
car* ret.: punches a standard input routine* and sets 
DOCTOR to punch standard checksummed data 
blocks c 
backspace: sets DOCTOR to punch standard checksummed 
data blocks, but punches no input routine, 
(A trn i7756 will be punched instead,) 
when a register is open, make the modification, if any, 
and punch a one word block containing that register, in 
format specified by H (see above). 
fa:laD punches data, blocks from fa through la in format speci- 
fied by H (above )„ fa and 1§ are any symbolic expres- 
sions , 
J punch a start (iump) block to the address specified to 

denote end of binary tape c 
2 zero all memory between register and the lowest regis- 
ter used by DOCTOR (contents of register F), 
fa:laZ zero memory between fa and la except that part, if any, 
occupied by DOCTOR. 
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HINTS AND KINKS 

Breakpoints are extremely useful for investigating misbe- 
havior of long programs. Do not try to break at program-modified in- 
structions, or TSX's followed by program parameters to be picked up 
by subroutines* 

If the operator types an undefined symbol t DOCTOR will re- 
spond with a U. All typed input up to that point is deleted auto- 
matical ly» 

If when attempting to type out a word as flexo code, the 
typewriter should hang, pressing Start Read will clear it, 

When trying to determine the best symbol to fit a given 
value, and given two equally good symbols, DOCTOR will pick the one 
last defined for its printout* 

There are two ways to print a block of registers. Either set 
the mask to z ero, set up M+l and M+2 to enclose the area to be 
printed and search for any word; or, if irrelevant parts of memory 
happen to contain zero, merely do an N-search for zero* If you 
change the mask or search limits, it is well to set them back to 
their usual values when you are through* 



Author Jfi^A^A^h^* Approved J 1 d£i M^Tyvvy^ 

R. A* Saunders C$ m B- Dennis 
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Summary of Control Characters 



A accumulator storage 

B Insert breakpoint 

C print words as constants 

D punch data blocks 

£ address search 

P lowest location in Doctor 

G go to 

H enter title punch (header) mode 

I equals as Instruction 

J punch start block 

K kill defined symbols 

L live register storage 

M mask register 

N not word search 

print addresses in octal 
P proceed 

Q last quantity 

R print locations in symbolic (relative) 

S print words in symbolic 

T read symbol table 

U execute as instruction 

V verify tape against memory 
W word search 

X index register storage 

Y read binary tape 
Z zero memory 

0-9 numerals and symbol constituents 

a-z symbol constituents 

1 take as flexo code 
3 print as flexo code 

8 print integers in octal 

print integers in decimal 
; set first argument value 

1 examine register 

/ examine register, print in symbolic 

( examine register s print in octal 

) define symbol 

* equals as octal constant 

current location or take as decimal 

, define symbol as current location 

define symbol as address typed 

~ minus 

+ plus 

(upper case minus) punch this register 

tape feed modify and open previous register 

delete delete 

tab modify and open addressed register 

bk sp modify and open next register 

car ret modify and close register 

uc^lc set case 

space plus 

all other ignored 9 but respond with X 



